package com.yupi.yupicturebackend.service;

import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.yupi.yupicturebackend.common.BaseResponse;
import com.yupi.yupicturebackend.exception.BusinessException;
import com.yupi.yupicturebackend.exception.ErrorCode;
import com.yupi.yupicturebackend.model.dto.picture.PictureQueryRequest;
import com.yupi.yupicturebackend.model.dto.picture.PictureReviewRequest;
import com.yupi.yupicturebackend.model.dto.picture.PictureUploadByBatchRequest;
import com.yupi.yupicturebackend.model.dto.picture.PictureUploadRequest;
import com.yupi.yupicturebackend.model.entity.Picture;
import com.baomidou.mybatisplus.extension.service.IService;
import com.yupi.yupicturebackend.model.entity.User;
import com.yupi.yupicturebackend.model.vo.pictureVo.PictureVO;
import org.springframework.web.multipart.MultipartFile;

import javax.servlet.http.HttpServletRequest;

/**
* @author Administrator
* @description 针对表【picture(图片)】的数据库操作Service
* @createDate 2025-07-07 15:53:49
*/
public interface PictureService extends IService<Picture> {

    /**
     * 上传图片
     *
     * @param inputSource      要上传的图片文件
     * @param pictureUploadRequest 包含图片相关信息的请求对象（如ID，用于修改）
     * @param loginUser            当前登录用户信息
     * @return                     返回封装后的图片信息（PictureVO）
     */
    PictureVO uploadPicture(Object inputSource,
                            PictureUploadRequest pictureUploadRequest,
                            User loginUser);

    /**
     * 根据查询请求构造数据库查询条件
     *
     * @param pictureQueryRequest 包含各种查询参数的请求对象
     * @return                      返回构建好的 MyBatis Plus 查询条件包装器
     */
    QueryWrapper<Picture> getQueryWrapper(PictureQueryRequest pictureQueryRequest);

    /**
     * 将图片实体转换为视图对象
     *
     * @param picture    图片实体对象
     * @param request    HTTP 请求对象，用于获取上下文信息
     * @return           返回封装后的图片视图对象（PictureVO）
     */
    PictureVO getPictureVO(Picture picture, HttpServletRequest request);


    /**
     * 将分页的图片实体对象转换为分页的图片视图对象
     *
     * @param picturePage           图片实体的分页对象
     * @param request               HTTP 请求对象，用于获取上下文信息
     * @return                      返回封装后的图片视图对象的分页结果
     */
    Page<PictureVO> getPictureVOPage(Page<Picture> picturePage, HttpServletRequest request);

    /**
     * 校验图片实体的合法性
     *
     * @param picture   需要校验的图片实体对象
     */
    void validPicture(Picture picture);

    /**
     * 处理图片审核逻辑
     *
     * @param pictureReviewRequest  包含审核状态、审核信息等审核相关参数的请求对象
     * @param request               HTTP 请求对象，用于获取当前审核的上下文信息
     */
    void doPictureReview(PictureReviewRequest pictureReviewRequest, HttpServletRequest request);

    /**
     * 填充图片审核相关的参数信息
     *
     * @param picture    需要填充参数的图片实体对象
     * @param loginUser  当前登录用户信息，作为审核人信息
     */
    void fillReviewParams(Picture picture, User loginUser);

    /**
     * 批量抓取和创建图片
     *
     * @param pictureUploadByBatchRequest
     * @param loginUser
     * @return 成功创建的图片数
     */
    Integer uploadPictureByBatch(
            PictureUploadByBatchRequest pictureUploadByBatchRequest,
            User loginUser
    );

    /**
     * 清理图片文件
     */
    void clearPictureFile(Picture oldPicture);
}
